Описание
Задает или возвращает определяемое пользователем имя объекта
доступа к данным (DAO). Для объекта, не добавленного в семейство, это
свойство доступно для чтения/записи.
Значение
Задаваемое или возвращаемое значение является выражением типа
String, указывающим имя объекта. Имя объекта должно начинаться с буквы.
Максимальный размер (в символах) значения свойства Name определяется
типом объекта, как показано в разделе "Дополнительные сведения". Имя может
содержать цифры и символы подчеркивания ( _ ), но не должно содержать
знаки препинания.
Замечания
Объект TableDef, QueryDef, Field,
Index, User и Group не может иметь имя, совпадающее с
именем другого объекта в том же семействе.
Значением свойства Name
объекта Recordset, открытого с помощью инструкции SQL, становятся
первые 256 символов инструкции SQL.
Допускается использование
свойства Name в инструкциях Dim в программах Visual Basic
для приложений (VBA) для создания новых экземпляров объекта.
Для
многих объектов доступа к данным (DAO) свойство Name отражает имя,
зарегистрированное в объекте Database. Это же относится к объектам
TableDef, Field или QueryDef. Прямой связи между именем
объекта и именем используемой для ссылок на объект базы данных объектной
переменной не существует.
Использование для чтения/записи свойства
Name при доступе к объекту определяется типом объекта, к которому
относится свойство, а также тем, был ли объект добавлен в семейство. В рабочей
области ODBCDirect свойство Name добавленного объекта всегда
доступно только для чтения. В следующей таблице показано, в каких случаях
свойство Name в рабочей области Microsoft Jet доступно для чтения
записи или только для чтения для объекта, добавленного в семейство (если иное не
указано). Для случая, когда свойство допускает чтение/запись, приведена
максимальная длина значения (в символах).
Объект Применение Длина Container Только чтение Connection Только чтение Database Только чтение Document Только чтение Field Не добавлен Чтение/запись 64 Добавлен в Index Только чтение Добавлен в QueryDef Только чтение Добавлен в Recordset Только чтение Добавлен в TableDef (таблица в базе данных) Чтение/запись 64 Добавлен в TableDef (присоединенная таблица ) Только чтение Добавлен в Relation Только чтение Group Не добавлен Чтение/запись 20 Добавлено Только чтение Index Не добавлен Чтение/запись 64 Добавлено Только чтение Parameter Только чтение Property Не добавлен Чтение/запись 64 Добавлено Только чтение Встроенный Только чтение QueryDef Не добавлен Чтение/запись 64 Временный Только чтение Добавлено Чтение/запись 64 Recordset Только чтение Relation Не добавлен Чтение/запись 64 Добавлено Только чтение TableDef Чтение/запись 64 User Не добавлен Чтение/запись 20 Добавлено Только чтение Workspace Не добавлен Чтение/запись 20 Добавлено Только чтение
Пример
Следующая программа использует свойство Name для указания
имени нового объекта, для вывода перечня объектов в семействе и для удаления
объекта из семейства.
Sub NameX()
Dim dbsNorthwind As Database
Dim qdfNew As QueryDef
Dim qdfLoop As QueryDef
Set dbsNorthwind = OpenDatabase("Борей.mdb")
With dbsNorthwind
' Создает новый постоянный объект QueryDef
' и добавляет его в семейство QueryDefs.
Set qdfNew = .CreateQueryDef()
qdfNew.Name = "NewQueryDef"
qdfNew.SQL = "SELECT * FROM Сотрудники"
.QueryDefs.Append qdfNew
' Отображает семейство имена объектов QueryDef
' в семействе QueryDefs.
Debug.Print "Имена запросов в " & .Name
For Each qdfLoop In .QueryDefs
Debug.Print " " & qdfLoop.Name
Next qdfLoop
' Удаляет новый объект QueryDef, созданный
' только для демонстрации.
.QueryDefs.Delete qdfNew.Name
.Close
End With
End Sub